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PART 15 

CHAPTER 1 

INTRODUCTION TO FILDMP 

1.1 INTRODUCTION 

File Dump (FILDMP) is a utility program for use with the PDP-11 Disk Operating 
System (DOS/BATCH). It can be used to enhance the debugging of programs by pro- 
viding a printed copy of the contents of all or specific blocks of a file for 
visual inspection. 

Printout of a file or block (s) of data can be directed from an input device to any 
device capable of ASCII output. 

FJCLDMP takes its input either as filenames or mass storage block numbers, and out- 
puts a dump in various formats. The printed dump is in a readable format. FILDMP 
is device independent in that the output can be stored on disk or tape for later 
printing. 

FILDMP command strings are interpreted by the DOS/BATCH Command String Interpreter 
(CSI), as explained in Chapter 3-6. For example, the general format of a FILDMP 
command string is: 

output file specification (s)<input file specification 



outdev : filename . ext/switch<indev : filename . ext/switch 

The output file specification on which the data is to appear is usually KB: (terminal) 
or LP: (line printer) , but can be a file on any mass storage device. The /switch 
represents FILDMP 's switch options. The input device, indev: , is the device on which 
the file is stored, the DOS/BATCH system device is assumed if no input device is 
specified. Note that all keyboard command strings are terminated with the RETURN key, 
which is non- printing. 

There may be any number of output file specifications (or none, in which case no 
output is generated). However, there must be exactly one input file specification. 
The entire command string must not be more than 72 decimal characters, the length 
of a teleprinter line. 
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1.2 RUNNING FILDMP 

FILDMP is loaded as a DOS/BATCH system program (see the DOS/BATCH System Manager's 
Guide) . It can then be called into core and executed with the DOS/BATCH Monitor 
RUN command. For example: 

$RUN FILDMP 
FILDMP Vxxx 

# 

FILDMP identifies itself and prints #, indicating its readiness to accept a user 
command string from the teleprinter keyboard. 
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PART 15 

CHAPTER 2 

SWITCHES 

FILDMP operations are controlled with switches in the command string. Switches 
are expressed using a slash and two letters, as shown below. There are two types 
of switches: input and output. 

2 . 1 INPUT SWITCHES 

Input switches are used to: 

1. Specify the format in which data is to be read. 

2. Determine the mass storage block numbers on which a file is stored. 

3. Specify the block or group of blocks to be dumped. 

Input switches can appear only in the input field of the command string, i.e., to 
the right of the < symbol. They are: 

/ BL read specified blocks of mass storage. /BL requires at least 
one value (block number), and will accept at most two values. 
The syntax for the /BL switch is: 

/BL:n or /BL:n:m 

where n and m are octal block numbers. 

/ CH causes FILDMP to obtain the numbers of the blocks which are 
allocated to the specified file. The input device must be a 
directory-structured device. 

/ FA read the input file in formatted ASCII mode. 

/ FB re ad the input file in formatted binary mode. 

FILDMP can read data in any of three modes: 

Unformatted binary default mode 
Formatted binary /fb 
Formatted ASCII /FA 

When no input switch is specified, data is read in . unformatted binary mode. Unfor- 
matted binary mode is assumed with the /BL switch 
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Only one type of input switch can appear in a command string. For example: 

DT: FILE. EXT/FA 
is legal, but 

DT : FILE . EXT/FA/FB 
is not. 
The /BL switch can appear more than once in a command string. For example: 

DT:/BL:1/BL:7:13/BL:22 
is legal, but 

DT:/BL:23/FA 

is not because only one type of input switch can appear in a command string. In 
the last example, block 23 will he dumped as directed followed by an error message 
when /FA is encountered. 

2.2 OUTPUT SWITCHES 

Output switches are used to specify the format in which the data is to be dumped. 
They should appear only in the output field of the command string, i.e., to the 
left of the < symbol. They are: 

/AS read successive bytes of the input file or mass storage block 
and output each byte as if it were a single ASCII character. 
The ASCII character set which FILDMP considers printable is 
(octal) 40 through 137 and 240 through 337. Any value outside 
these ranges is printed as if it were 137, a special printing 
character; for example, a left arrow or a heart-shaped character. 

/BY output the input file or mass storage block (s) as a sequence 
of octal bytes. 

/OC output the input file or mass storage block (s) as a sequence 
of octal words. 

/ra read successive words of the input file or mass storage block (s), 
consider each word as a three-character, packed Radix-50 entity, 
and unpack and output it as such. 

When no output switch is specified, the /OC switch is assumed. 
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Output switches can be used to direct FILDMP to perform certain modes of translation, 
e.g., a binary file can be dumped in ASCII. However, the /CH switch overrides any 
output switch and causes output to appear in octal words. 

Multiple output file specifications are allowed and, in fact, are common. For 
example, to dump FILE. EXT (a file written in formatted ASCII mode) in octal words 
and ASCII characters, use the following command string: 

LP : /OC , LP : /AS<FILE . EXT/FA 

where the line printer is the output device and FILE. EXT is on the system disk, In 
the above example, FILE. EXT is read in formatted ASCII mode and dumped in octal 
words, and then read in formatted ASCII mode and dumped as ASCII characters. If, 
for example, FILE. EXT were on "paper tape, it would be necessary to reload the paper 
tape prior to generating the second output. The command string would be: 

LP : /OC , LP : /AS <PR : /FA 

The command string: 

LP : /BY , KB : /RA<DF : /BL : 3/BL : 17 : 21 

directs FILDMP to dump disk (DF:) blocks 3, 17, 20, and 21 on the line printer in 
octal byte format, and then on the teleprinter in unpacked Radix-50 format, 

2.3 OUTPUT FORMATS 

The output or printed format of the dump differs slightly, depending on the switch 
used. If no input switch (implied unformatted binary mode) or the /BL switch is 
specified, the leftmost column of the output is the byte count of the file or mass 
storage block. If the /FA or /FB switch is specified, the leftmost column of the 
output is the line number of the file. The physical output line which begins with 
the line number contains the status and mode bytes and the byte count word as well. 

Read errors are indicated by an E between the line number and the status byte. The 
status byte gives detailed information concerning the error. The E error message 
appears only on dumps where the input is read in a formatted mode. 

If /CH appears in the input field, the output is the block numbers, in sequential 
order, occupied by the file. No byte count or line count appears. 
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The output of FILDMP contains a form of identifier. If /BL appears, FILDMP prints 
the device name and block number (in octal) prior to dumping any given block. Other- 
wise, the input filename and extension, as specified in the command input, will 
appear, followed by: 

(ASCII) if the /AS switch is used. 

(BYTES) if the /BY switch is used. 

(CHAIN) if the /CH switch is used. 

(OCTAL) if the /OC switch is used or assumed. 

(RAD50) if the /RA switch is used. 

If the input file were read as a file (i.e., /FA, /FB, or no switch), FILDMP 
terminates its output with: 

END OF FILE 

The END OF FILE message does not appear on those dumps which use the /CH or /BL 
switch. 

2.4 DUMPING ENTIRE FILES 

Unless the /BL switch (see Chapter) is specified, FILDMP dumps the entire 
file indicated. When FILDMP encounters an end-of-file (EOF) , it prints 

END OF FILE 

closes and releases all files, and then prints # to indicate readiness for another 
command string. 

2.5 DETERMINING FILE BLOCKS, /CH 

The /CH switch is helpful in determining the block size of a program and in pin- 
pointing certain blocks of data for future referencing with other FILDMP operations. 
For example: 

#KB:<DEMO/CH 

DEMO (CHAIN) 

002252 002262 
#KB:<SIZE/CH 

SIZE (CHAIN) 

001700 .001705 001712 001717 
001750 001755 001762 
002020 
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DEMO is a file which is stored in the two blocks numbered 002252 and 002262. 
SIZE is a file which is stored in the 17 blocks numbered as shown. 

When using the /CH option, if FILDMP cannot find the input file, then the error 
message S206 (no input file) is printed, followed by #. (m no other case does 
FILDMP attempt to predetermine the existence of its input file, i.e., if the input 
file is not found, F012 results.) 

2.6 DUMPING BLOCKS OF DATA, /BL 

The block switch, /BL, is used to indicate the dumping of a specific block or group 
of contiguous blocks. More than one /BL switch can be specified in a command 
string. Each /BL switch requires at least one and at most two arguments (block 
numbers), and each argument is preceded by a colon. For example, the following 
command string dumps the contents of block 2252 in ASCII characters: 

#LP : /AS<DF : /BL : 2 2 52 

The following command string dumps blocks 17 through 43 in octal words: 

#LP :/OC<DTl : /BL : 17 : 43 

The following command string dumps blocks 15 through 21, block 32, and blocks 113 
through 121 in octal bytes: 

#LP:/BY<DK:/BL:15:21/BL:32/BL:113:121 
The /BL switch reads input in unformatted binary only. 
The following command string dumps blocks 70 and 100 in octal and then in Radix-50. 

#LP : /OC ,.LP : /RA<DT : /BL : 70/BL : 100 
2.7 DUMPING RADIX-50 FORMATTED DATA, /RA 

The /RA switch can be used to dump Radix-50 formatted data in ASCII characters. 
The /RA switch causes FILDMP to unpack the data (three ASCII characters are 
packed into one word) . 

This switch can be useful when "looking" at the data stored in Radix-50 format, 
e.g., internal directories, etc. 
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The /RA switch can be used alone or with the /FA, /FB, or /BL switch, For example: 
#LP:/RA</BL:2:3 

FILDMP would dump blocks 2 and 3 of the DOS/BATCH system device in unpacked Radix-50 
format. 
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. PART 15 
CHAPTER 3 
SAMPLE OUTPUT 

The following example is not intended to be a practical example of the uses of 
FILDMP. Rather it is intended to show as many examples of the FILDMP options, 
output formats, and error notations as possible. 

EXAMPLE 1 

The FORTRAN source program RAD50.F4, listed below, writes 30 records of 12 words 
each containing the characters A-Z and 0-9 in packed RADIX-50 format. The output 
is to a file named FOR001.DAT on the system device. The RADIX-50 packing procedure 
is described in Chapter 7-12. The CALL SETERR requests that the overflow into 
bit 15 (the sign bit) be ignored while the RADIX-50 characters are being packed. 



DIMFNSJQN INC36) 

DIMFK'SIOM TQUTHSn 

DPFTNIF FILF. lf30,12.U.lFR(M 

C4LI SFTFRPC3,-1) 

IFTFa4P) 

DO K J«l f 26 
5 IN(.?)«J 

DO 10 J«!?7,36 
10 lNf-TW + 3 

DO 15 J«J,»12 

T«(J-l)*3+i 

15 I0UT(J)«'((TN(I)*lFlF) + lNa + m*IFIF+lN(Tf2) 

DO 90 J«l,30 

WRITFCI'J) flOUT(T).I»l.l2l 
20 CONTINUE 

CAU EXIT 

FNf) 



EXAMPLE 2 

The FILDMP command string is used to get an ASCII dump of the source file RAD50.F4. 
The resulting output follows. 
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*LP!/A$<BAD50.F4 



RAD50 .F4 


(ASCII) 












0000000 OD 


IM 


FN 


SI 


ON 


I 


N( 


0000090 )0 


00 


DT 


ME 


NS 


10 


N 


0000040 UT 


M 


21 


00 


<?D 


FF 




00000*0 FI 


I.F 


1 


(3 


0. 






0000100 FR 


R) 





oc 








00001*0 RR 


(3 


f m 










0000140 40 


00 












00081*0 00 














0000200 















36 















Tt 












FI 


F) 










IF 


IF 


♦ I 








<>D 





20 


J 






00 


WR 


IT 


EC 


1' 




in 


UT 


(I 


). 


!■ 


1* 


10 


o? 


00 


co 


NT 


IN 


UE 


00 oc 


Al' 


L 


FX 


IT 


00 


«E 


00004*0 NO 00 














Fwn OF filf 















EXAMPLE 3 

The FILDMP command string shewn below is used to get a byte dump of the source file. 

The resulting output follows. 

#LP*/RY<RADS0.F4 

RADS0 *.F4 (BYTFSV 

0000000 011 104 111 11.5 1,05 116 123 111 117 156 040 111 116 050 063 066 

0000090 051 015 012 011 104 HI 115 105 116 133 111 117 116 040 

0000040 125 124 050 061 06? 051 015 012 011 104 105 106 

00080*0 106 111 114 105 040 061 050 063 060 0fi4 

0000100 105 122 122 051 015 012 011 103 

0000130 122 122 050 063 054 055 

0000140 064 060 015 012 

00001*0 015 012 

0000200 





























124 


050 


























106 


111 106 


05! 






















111 


106 


111 


106 053 


Ill 


















011 


104 


117 


040 


062 


060 040 


112 














012 


011 


127 


132 


111 


124 


105 


050 061 


047 










HI 


117 


125 


124 


050 


111 


05! 


054 


HI 


075 061 


054 






051 


015 


012 


062 


060 


011 


103 


117 


116 


124 


111 


116 125 


105 




015 012 


011 


103 


101 


114 


114 


040 


105 


130 


111 


124 


015. 


012 011 


105 


00004*0 


116 104 


015 


01? 
























END 


OF FILF 
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EXAMPLE 4 

The FILDMP command string shown below is used to get an octal dump of the source 
file. The resulting output follows. 

RADR0 ,?4 (OCTAL) 

0000000 042ftH M65U 047105 044523 047117 044440 024116 031063 

0000090 006451 004412 044504 0425*5 05151ft 047511 J--" 

0000040 052125 030450 024462 005015 

00000*0 044506 042514 
00001PI0 



* * 



024105 02T4M 

044450 026051 036511 02*061 

031&12 004460 047501 052116 047111 042525 

00004*0 S"l|S 005015 34fi,0, B2 " M " 4,M " a, ' n •"»•«» '"«» 

FMD OF FILE 



EXAMPLE 5 

After the source file is compiled to an object file, RAD50.OBJ, the numbers of the 
physical blocks on the system device that contain the file are determined by use of 
the following FILDMP command: 

#LPt<&Ar>50.npJ/CM 
RAQ50 .OP.T (CHAIN) 

000352 000360 000361 ' 000362 
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EXAMPLE 6 



To dump selected blocks of the object file in octal format (the default output 
format) the following FILDMP command is used: 
*LPt<»Ar>5l3.nBJ/BL!35?/BL S-361 
OK 030352 (OCTAL) 



0000000 000360 000001 000056 00G001 

0000090 127401 007624 000410 000000 

0000040 073634 021042 002100 0001300 

00000*0 000235 030001 
0000100 



031002 015001 
00007*0 000001 0tf0032 



125675 
001004 
000003 



065100 
016001 
000034 



050561 
021411 



125517 

013002 
00100ft 

000000 



055740 

076400 



047000 
124545 
017001 
000004 



000000 000000 



001010 
004002 
023364 
001010 
000774 



000174 
125361 
014001 
000123 
000000 



OK 

000000(0 
0830020 
0000040 
0000060 
0000100 
000076(7! 



000361 (OCTAL) 



000362 
001060 
000004 
001*60 
125067 
001060 



000001 
030470 
002002 
006001 
034100 
010001 



000030 
000000 
125675 
000056 
005002 
001006 



000003 
001026 
06*100 
000004 
124626 
011001 



000242 
000000 

001060 
002002 
014657 

000400 



000000 
000263 
001006 
125523 
006001 
012002 



000014 
000410 

000400 
031000 
001002 
125067 



000000 
000000 
000000 
004002 
007001 
022600 



EXAMPLE 7 

The data file containing the packed RADIX-50 characters, FOR001.DAT, may be dumped 
in unpacked RADIX-50 format by using the following FILDMP command string. The 
resulting output follows. 



#LPl/»A<FOR001.D4T 
FOR001.OAT (RAO50) 



0000000 


ABC 


OEF 


CHI 


0000020 





3 


6 


0000040 


MMO 


PQR 


STU 


0000060 


ABC 


OFF 


GHI 


0000100 


0' 


3 


6 


0000120 


MNC 


PQR 


STU 


0000140 


ABC 


OEF 


GHJ 


0000160 





3 




0000200 


MNP 






0000220 

• 








• 

0001700 








0001720 








0001740 








0001760 








END 


OF FILF 







JK! 



JK! 



i 


MNO 


PQR 


STU 


Q 


ABC 


DEF 


GHI 


V 





3 


6 


I 


MNO 


PQR 




9 


ABC 






y 









JKL 
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EXAMPLE 8 

To dump the data file in octal (to see the packed RADIX-50 format) the FILDMP 
command shown below is used. The associated output follows. 

*LPl/nC<FORfl01.DAT 
FnR00l'.DAT (OCTAL) 



0000000 
0000090! 
0000040 
00000*0 
00001(710 
00001^0 
0000140 
00001*0 
0000200 



003923 
000036 
051577 
003223 
020036 
051577 

003923 
000036 



000000 
0001700 000000 
0001720 000000 
0001740 000000 
0001760 000000 

% , E^n OF PTLF 



014716 
000041 
063272 
014716 

000041 
063272 
014716 

000041 



000000 
000000 
000000 
000000 
000000 



026411 
000044 
074765 
026411 

074765 

096411 



000000 
000000 
000000 
000000 
000000 
000000 



04(*104 
000047 
000030 
040104 
^Vtt^Q47 
000030 
040104 



000000 

000000 
000000 
000000 
000000 
000000 



051577 

003223 
00003fi 
051577 

003223 
00003* 



000000 

00000a 

000000 
000000 

000000 

000000 
000000 



063272 
014716 
000041 
063972 

014716 
000041 



000000 
000000 
000000 
000000 
000000 
000000 
000000 



074765 
026411 
000044 
f^7A7«5 
026411 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000030 
040104 
^9^947 
000030 
040104 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



EXAMPLE. 9 

If the data file is mistakenly specified as being in formatted binary (the file is 
actually in unformatted binary, the FILDMP default input file format), FILDMP en- 
counters errors as it tries to read the input file. -An example of this FILDMP 
command string and the resulting output are shown below. 

#LP!<FO»001 f .pAT/FB 
Ff1R001.DAT (OCTAL) 



000000 


F004 


001 


000000 


000001 


P004 


001 


000000 


000009 


F004 


001 


000000 


000003 


F004 


001 


000000 


000004 


F004 


001 


000000 


000005 


F004 


001 


000000 


000006 


F004 


001 


000000 


000007 


F004 


001 


000000 


000010 


F004 


001 


000000 



000257 F(*04 00J ^00000 

000260 F-0UJ4 001 000000 

000261 F004 001 000000 
000269 F004 p!01 000000 
000263 F004 001 000000 

E*D OF FILE 
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